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Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Scope 



The present document defines a transport protocol for use in the IP multimedia (IM) Core Network (CN) subsystem 
based on Diameter. 

The present document is applicable to: 

The Sh interface between an AS and the HSS. 

The Sh interface between an SCS and the HSS. 

Whenever it is possible this document specifies the requirements for this protocol by reference to specifications 
produced by the IETF within the scope of Diameter. Where this is not possible, extensions to Diameter are defined 
within this document. 



References 



The following documents contain provisions, which through reference in this text constitute provisions of the present 
document. 

References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

For a specific reference, subsequent revisions do not apply. 

For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 29.328 "IP Multimedia (IM) Subsystem Sh interface; signalling flows and message 

contents" 

[2] 3GPP TS 33.210 "3G Security; Network Domain Security; IP Network Layer Security" 

[3] IETF RFC 2960 "Stream Control Transmission Protocol" 
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[4] IETF RFC 3588 "Diameter Base Protocol" 

[5] IETF RFC 2234 "Augmented BNF for syntax specifications" 

[6] 3GPP TS 29.229 "Cx and Dx Interfaces based on the Diameter protocol; protocol details" 

[7] IETF RFC 3589 "Diameter Command Codes for Third Generation Partnership Project (3GPP) 

Release 5" 

[8] ITU-T Recommendation E. 164: "The international public telecommunication numbering plan" 

[9] 3GPP TR 33.978 "Security aspects of early IP Multimedia Subsystem (IMS) (Release 6)" 

3 Definitions, symbols and abbreviations 

3.1 Definitions 

Refer to IETF RFC 3588 [4] for the definitions of some terms used in this document. 

For the purposes of the present document, the following terms and definitions apply. 

Attribute- Value Pair: see IETF RFC 3588 [4], it corresponds to an Information Element in a Diameter message. 

Server: SIP-server. 

User data: user profile data. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

AAA Authentication, Authorization and Accounting 

AS Application Server 

ABNF Augmented Backus-Naur Form 

AVP Attribute-Value Pair 

CN Core Network 

HSS Home Subscriber Server 

lANA Internet Assigned Numbers Authority 

IETF Internet Engineering Task Force 

IMS IP Multimedia Subsystem 

NDS Network Domain Security 

RFC Request For Comment 

SCTP Stream Control Transport Protocol 

UCS Universal Character Set 

URL Uniform Resource Locator 

UTF UCS Transformation Formats 



General 



The Diameter Base Protocol as specified in IETF RFC 3588 [4] shall apply except as modified by the defined support 
of the methods and the defined support of the commands and AVPs, result and event codes specified in clause 6 of this 
specification. Unless otherwise specified, the procedures (including error handling and unrecognised information 
handling) are unmodified. 
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Use of the Diameter base protocol 



The same clarifications of section 5 of 3GPP TS 29.229 [6] shall apply to the Sh interface. An exception is that the 
application identifier for this application is defined in chapter 6. 



6 Diameter application for Sh interface 

This clause specifies a Diameter application that allows a Diameter server and a Diameter client: 

to download and update transparent and non-transparent user data 

to request and send notifications on changes on user data 

The Sh interface protocol is defined as an IETF vendor specific Diameter application, where the vendor is 3GPP. The 
vendor identifier assigned by IAN A to 3GPP ( http://www.iana.org/assignments/enterpi'ise-numbers ) is 10415. 

The Diameter application identifier assigned to the Sh interface appUcation is 16777217 (allocated by lANA). 



6.1 



Command-Code values 



This section defines Command-Code values for this Diameter application. 

Every command is defined by means of the ABNF syntax (as defined in RFC 2234 [5]), according to the rules in IETF 
RFC 3588 [4]. Whenever the definition and use of an AVP is not specified in this document, what is stated in 3GPP TS 
29.229 [6] shall apply. 

The command codes for the Sh interface application are taken from the range allocated by lANA in IETF RFC 3589 [7] 
as assigned in this specification. For these commands, the Application-ID field shall be set to 16777217 (application 
identifier of the Sh interface application, allocated by lANA). 

The following Command Codes are defined in this specification: 

Table 6.1.1 : Command-Code values 



Command-Name 


Abbreviation 


Code 


Section 


User-Data-Request 


UDR 


306 


6.1.1 


User-Data- Answer 


UDA 


306 


6.1.2 


Profile-Update-Request 


PUR 


307 


6.1.3 


Profile-Update-Answer 


PUA 


307 


6.1.4 


Subscribe-Notifications-Request 


SNR 


308 


6.1.5 


Subscribe-Notifications-Answer 


SNA 


308 


6.1.6 


Push-Notification-Request 


PNR 


309 


6.1.7 


Push-No ti fie ation- Answer 


PNA 


309 


6.1.8 



6.1 .1 User-Data-Request (UDR) Command 

The User-Data-Request (UDR) command, indicated by the Command-Code field set to 306 and the 'R' bit set in the 
Command Flags field, is sent by a Diameter client to a Diameter server in order to request user data. 

Message Format 
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< User-Data -Request> ::= 



< Diameter Header: 306, REQ, PXY, 16777217 > 
< Session-Id > 

{ Vendor-Specific-Application-Id } 
{ Auth-Session-State } 
{ Origin-Host } 
{ Origin-Realm } 
[ Destination-Host ] 
{ Destination-Realm } 
*[ Supported-Features ] 
{ User-Identity } 
[ Server-Name ] 
*[ Service-Indication ] 
*{ Data-Reference } 
*[ Identity-Set ] 
[ Requested-Domain ] 
[ Current-Location ] 
*[ AVP ] 
*[ Proxy-Info ] 
*[ Route-Record ] 



6.1 .2 User-Data-Answer (UDA) Command 

The User-Data- Answer (UDA) command, indicated by the Command-Code field set to 306 and the 'R' bit cleared in 
the Command Flags field, is sent by a server in response to the User-Data-Request command. The Experimental-Result 
AVP may contain one of the values defined in section 6.2 or in 3GPP TS 29.229 [6]. 



Message Format 



< User-Data- Answer > 



< Diameter Header: 306, PXY, 16777217 > 
< Session-Id > 

{ Vendor-Specific-Application-Id } 
[ Result-Code ] 
[ Experimental-Result ] 
{ Auth-Session-State } 
{ Origin-Host } 
{ Origin-Realm } 
*[ Supported-Features ] 
[ User-Data ] 
*[ AVP ] 
*[ Failed- AVP ] 
*[ Proxy-Info ] 
*[ Route-Record ] 



6.1 .3 Profile-Update-Request (PUR) Command 

The Profile-Update-Request (PUR) command, indicated by the Command-Code field set to 307 and the 'R' bit set in 
the Command Flags field, is sent by a Diameter client to a Diameter server in order to update user data in the server. 



Message Format 



< Profile-Update-Request > ::= 



< Diameter Header: 307, REQ, PXY, 16777217 > 

< Session-Id > 

{ Vendor-Specific-Application-Id } 

{ Auth-Session-State } 

{ Origin-Host } 

{ Origin-Realm } 

[ Destination-Host ] 

{ Destination-Realm } 

*[ Supported-Features ] 

{ User-Identity } 

{ Data-Reference } 

{ User-Data } 
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*[ AVP ] 

*[ Proxy-Info ] 

*[ Route-Record ] 

6.1 .4 Profile-Update-Answer (PUA) Command 

The Profile-Update-Answer (PUA) command, indicated by the Command-Code field set to 307 and the 'R' bit cleared 
in the Command Flags field, is sent by a server in response to the Profile-Update-Request command. The Experimental- 
Result AVP may contain one of the values defined in section 6.2 or in 3GPP TS 29.229 [6]. 

Message Format 

< Profile-Update-Answer > ::=< Diameter Header: 307, PXY, 16777217 > 

< Session-Id > 

{ Vendor-Specific-Application-Id } 

[ Result-Code ] 

[ Experimental-Result ] 

{ Auth-Session-State } 

{ Origin-Host } 

{ Origin-Realm } 

*[ Supported-Features ] 

*[ AVP ] 

*[ Failed- AVP ] 

*[ Proxy-Info ] 

*[ Route-Record ] 

6.1 .5 Subscribe-Notifications-Request (SNR) Command 

The Subscribe-Notifications-Request (SNR) command, indicated by the Command-Code field set to 308 and the 'R' bit 
set in the Command Flags field, is sent by a Diameter client to a Diameter server in order to request notifications of 
changes in user data. 

Message Format 

< Subscribe-Notifications-Request > ::= < Diameter Header: 308, REQ, PXY, 16777217 > 

< Session-Id > 

{ Vendor-Specific-Application-Id } 

{ Auth-Session-State } 

{ Origin-Host } 

{ Origin-Realm } 

[ Destination-Host ] 

{ Destination-Realm } 

*[ Supported-Features ] 

{ User-Identity } 

*[ Service-Indication ] 

[ Send-Data-Indication ] 

[ Server-Name ] 

{ Subs-Req-Type } 

*{ Data-Reference } 

[ Identity-Set ] 

[ Expiry-Time ] 

*[ AVP ] 

*[ Proxy-Info ] 

*[ Route-Record ] 

6.1 .6 Subscribe-Notifications-Answer (SNA) Command 

The Subscribe-Notifications-Answer command, indicated by the Command-Code field set to 308 and the 'R' bit cleared 
in the Command Flags field, is sent by a server in response to the Subscribe-Notifications-Request command. The 
Result-Code or Experimental-Result AVP may contain one of the values defined in section 6.2 or in 3GPP TS 29.229 
[6]. 

Message Format 
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< Subscribe-Notifications-Answer > ::= < Diameter Header: 308, PXY, 16777217 > 

< Session-Id > 

{ Vendor-Specific-Application-Id } 

{ Auth-Session-State } 

[ Result-Code ] 

[ Experimental-Result ] 

{ Origin-Host } 

{ Origin-Realm } 

*[ Supported-Features ] 

[ User-Data ] 

[ Expiry-Time ] 

*[ AVP ] 

*[ Failed- AVP ] 

*[ Proxy-Info ] 

*[ Route-Record ] 

6.1 .7 Push-Notification-Request (PNR) Command 

The Push-Notification-Request (PNR) command, indicated by the Command-Code field set to 309 and the 'R' bit set in 
the Command Flags field, is sent by a Diameter server to a Diameter client in order to notify changes in the user data in 
the server. 

Message Format 

< Push-Notification-Request > ::= < Diameter Header: 309, REQ, PXY, 16777217 > 

< Session-Id > 

{ Vendor-Specific-Application-Id } 

{ Auth-Session-State } 

{ Origin-Host } 

{ Origin-Realm } 

{ Destination-Host } 

{ Destination-Realm } 

*[ Supported-Features ] 

{ User-Identity } 

{ User-Data } 

*[ AVP ] 

*[ Proxy -Info ] 

*[ Route-Record ] 

6.1 .8 Pusin-Notifications-Answer (PNA) Command 

The Push-Notifications-Answer (PNA) command, indicated by the Command-Code field set to 309 and the 'R' bit 
cleared in the Command Flags field, is sent by a client in response to the Push-Notification-Request command. The 
Experimental-Result AVP may contain one of the values defined in section 6.2 or in 3GPP TS 29.229 [6]. 

Message Format 

< Push-Notification-Answer > ::=< Diameter Header: 309, PXY, 16777217 > 

< Session-Id > 

{ Vendor-Specific-Application-Id } 

[ Result-Code ] 

[ Experimental-Result ] 

{ Auth-Session-State } 

{ Origin-Host } 

{ Origin-Realm } 

*[ Supported-Features ] 

*[ AVP ] 

*[ Failed- AVP ] 

*[ Proxy-Info ] 

*[ Route-Record 1 
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6.2 Result-Code AVP values 

This section defines new result code values that must be supported by all Diameter implementations that conform to this 
specification. The result codes defined in 3GPP TS 29.229 [6] are also applicable. When one of the result codes defined 
here is included in a response, it shall be inside an Experimental-Result AVP and Result-Code AVP shall be absent. 

6.2.1 Success 

Result codes that fall within the Success category are used to inform a peer that a request has been successfully 
completed. 

No result codes within this category have been defined so far. 

6.2.2 Permanent Failures 

Errors that fall within the Permanent Failures category are used to inform the peer that the request failed, and should not 
be attempted again. 

6.2.2.1 DIAMETER_ERROR_USER_DATA_NOT_RECOGNIZED (5100) 

The data received by the AS is not supported or recognized. 

6.2.2.2 DIAMETER_ERROR_OPERATION_NOT_ALLOWED (5101) 

The requested operation is not allowed for the user 

6.2.2.3 DIAMETER_ERROR_USER_DATA_CANNOT_BE_READ (5102) 

The requested user data is not allowed to be read. 

6.2.2.4 DIAMETER_ERROR_USER_DATA_CANNOT_BE_MODIFIED (5103) 

The requested user data is not allowed to be modified. 

6.2.2.5 DIAMETER_ERROR_USER_DATA_CANNOT_BE_NOTIFIED (5104) 

The requested user data is not allowed to be notified on changes. 

6.2.2.6 DIAMETER_ERROR_TOO_MUCH_DATA (5008) 

The size of the data pushed to the receiving entity exceeds its capacity. This error code is defined in 3GPP TS 29.229 
[6]. 

6.2.2.7 DIAMETER_ERROR_TRANSPARENT_DATA OUT_OF_SYNC (51 05) 

The request to update the repository data at the HSS could not be completed because the requested update is based on 
an out-of-date version of the repository data. That is, the sequence number in the Sh-Update Request message, does not 
match with the immediate successor of the associated sequence number stored for that repository data at the HSS. It is 
also used where an AS tries to create a new set of repository data when the identified repository data already exists in 
the HSS. 

6.2.2.8 DIAMETER_ERROR_FEATURE_UNSUPPORTED (501 1 ) 

See 3GPP TS 29.229 [6] clause 6.2.2.11. 

6.2.2.9 DIAMETER_ERROR_SUBS_DATA_ABSENT (5106) 

The Application Server requested to subscribe to changes to Repository Data that is not present in the HSS. 
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6.2.2.10 DIAMETER_ERROR_NO_SUBSCRIPTION_TO_DATA (5107) 

The AS received a notification of changes of some information to which it is not subscribed. 

6.2.2.1 1 DIAMETER_ERROR_DSALNOT_AVAILABLE (51 08) 

The Application Server addressed a DSAI not configured in the HSS. 

6.2.3 Transient Failures 

Errors that fall within the transient failures category are those used to inform a peer that the request could not be 
satisfied at the time that it was received. The request may be able to be satisfied in the future. 

6.2.3.1 DIAMETER_USER_DATA_NOT_AVAILABLE (4100) 

The requested user data is not available at this time to satisfy the requested operation. 

6.2.3.2 DIAMETER_PRIOR_UPDATEJN_PROGRESS (4101) 

The request to update the repository data at the HSS could not be completed because the related repository data is 
currently being updated by another entity. 



6.3 



AVPs 



The following table describes the Diameter AVPs defined for the Sh interface protocol, their AVP Code values, types, 
possible flag values and whether the AVP may or not be encrypted. 

Table 6.3.1 : Diameter Multimedia Application AVPs 











AVP Flag rules 




Attribute Name 


AVP 

Code 


Section 
defined 


Value Type 


Must 


May 


Should 
not 


Must 
not 


May 
Encrypt 


User-Identity 


700 


6.3.1 


Grouped 


M,V 








No 


MSISDN 


701 


6.3.2 


OctetString 


M, V 








No 


User-Data 


702 


6.3.3 


OctetString 


M, V 








No 


Data-Reference 


703 


6.3.4 


Enumerated 


M, V 








No 


Service-Indication 


704 


6.3.5 


OctetString 


M, V 








No 


Subs-Req-Type 


705 


6.3.6 


Enumerated 


M, V 








No 


Requested-Domain 


706 


6.3.7 


Enumerated 


M, V 








No 


Current-Location 


707 


6.3.8 


Enumerated 


M, V 








No 


Identity-Set 


708 


6.3.10 


Enumerated 


V 






M 


No 


Expiry-Time 


709 


6.3.16 


Time 


V 






M 


No 


Send-Data-Indication 


710 


6.3.17 


Enumerated 


V 






M 


No 


Server-Name 


602 


6.3.9 


UTF8String 


M, V 








No 


Supported-Features 


628 


6.3.11 


Grouped 


V 


M 






No 


Feature-List-ID 


629 


6.3.12 


Unsigned32 


V 






M 


No 


Feature-List 


630 


6.3.13 


Unsigned32 


V 






M 


No 
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Supported- Applications 


631 


6.3.14 


Grouped 


V 






M 


No 


Public-Identity 


601 


6.3.15 


UTFSString 


M, V 








No 


DSAI-Tag 


711 


6.3.18 


OctetString 


M, V 








No 


NOTE 1: The AVP header bit denoted as 'M', indicates whether support of the AVP is required. The AVP header 
bit denoted as 'V, indicates whether the optional Vendor-ID field is present in the AVP header. For further 
details, see 3GPP TS 29.229 [6]. 



6.3.1 User-Identity AVP 

The User-Identity AVP is of type Grouped. This AVP contains either a Public- Identity AVP or an MSISDN AVP. 
AVP format 

User-Identity ::= <AVP header: 700 10415> 
[Public -Identity] 

[MSISDN] 
*[AVP] 

6.3.2 MSISDN AVP 

The MSISDN AVP is of type OctetString. This AVP contains an MSISDN, in international number format as described 
in ITU-T Rec E. 164 [8], encoded as a TBCD-string, i.e. digits from through 9 are encoded 0000 to 1001 ; 1111 is used 
as a filler when there is an odd number of digits; bits 8 to 5 of octet n encode digit 2n; bits 4 to 1 of octet n encode digit 
2(n-l)H-l. 

6.3.3 User-Data AVP 

The User-Data AVP is of type OctetString. This AVP contains the user data requested in the PUR and SNR operations 
and the data to be modified in the UPR operation . The exact content and format of this AVP is described in 3GPP TS 
29.328 [1]. 

6.3.4 Data-Reference AVP 

The Data-Reference AVP is of type Enumerated, and indicates the type of the requested user data in the operation UDR 
and SNR. Its exact values and meaning is defined in 3GPP TS 29.328 [1]. The following values are defined (more 
details are given in 3GPP TS 29.328 [1]): 

RepositoryData (0) 

IMSPublicIdentity(lO) 

IMSUserState(ll) 

S-CSCFName (12) 

InitialFilterCriteria (13) 

This value is used to request initial filter criteria relevant to the requesting AS 

Locationlnformation (14) 

UserState (15) 

Charginglnformation (16) 

MSISDN (17) 
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PSIActivation(18) 

DSAI (19) 

AliasesRepositoryData (20) 

NOTE: Value 10000 is reserved in Release 6 for use with Early IMS Security, see 3GPP TR 33.978 [9]. 

6.3.5 Service-Indication AVP 

The Service-Indication AVP is of type OctetString. This AVP contains the Service Indication that identifies a service in 
an AS. 

6.3.6 Subs-Req-Type AVP 

The Subs-Req-Type AVP is of type Enumerated, and indicates the type of the subscription-to-notifications request. The 
following values are defined: 

Subscribe (0) 

This value is used by an AS to subscribe to notifications of changes in data. 
Unsubscribe (1) 

This value is used by an AS to unsubscribe to notifications of changes in data. 



6.3.7 Requested-Domain AVP 



The Requested-Domain AVP is of type Enumerated, and indicates the access domain for which certain data (e.g. user 
state) are requested. The following values are defined: 

CS-Domain (0) 

The requested data apply to the CS domain. 
PS-Domain (1) 

The requested data apply to the PS domain. 

6.3.8 Current-Location AVP 

The Current-Location AVP is of type Enumerated, and indicates whether an active location retrieval has to be initiated 
or not: 

DoNotNeedlnitiateActiveLocationRetrieval (0) 

The request indicates that the initiation of an active location retrieval is not required. 
Initiate ActiveLocationRetrieval ( 1 ) 

It is requested that an active location retrieval is initiated. 

6.3.9 Server-Name AVP 

The Server-Name contains a SIP-URL used to identify an AS. See 3GPP TS 29.229 [6] for further description of this 
AVP. 



6.3.10 Identity-Set AVP 



The Identity-Set AVP is of type Enumerated and indicates the requested set of IMS Public Identities. The following 
values are defined: 
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ALLJDENTITIES (0) 
REGISTEREDJDENTITIES (1) 
IMPLICITJDENTITIES (2) 
ALIASJDENTITIES (3) 

6.3.1 1 Supported-Features AVP 

See 3GPP TS 29.229 [6] clause 6.3.29. 

6.3.12 Feature-List-ID AVP 

See 3GPP TS 29.229 [6] clause 6.3.30. 

6.3.13 Feature-List AVP 

See 3GPP TS 29.229 [6] clause 6.3.31. 

6.3.14 Supported-Applications AVP 

See 3GPP TS 29.229 [6] clause 6.3.32. 

6.3.15 Public-Identity AVP 

The Public-Identity AVP contains a Public User Identity. See 3GPP TS 29.229 [6] for the definition of this AVP. 

6.3.16 Expiry-Time AVP 

The Expiry-Time AVP is of type Time. This AVP contains the expiry time of subscriptions to notifications in the HSS. 

6.3.17 Send-Data-lndication AVP 

The Send-Data-lndication AVP is of type Enumerated. If present it indicates that the sender requests the User-Data. The 
following values are defined: 

USER_DATA_NOT_REQUESTED (0) 

USER_DATA_REQUESTED (1) 

6.3.18 DSAI-TagAVP 

The DSAJ-Tag AVP is of type OctetString. This AVP contains the tag identifying the instance of dynamic information 
being accessed. 



6.4 Use of namespaces 



This clause contains the namespaces that have either been created in this specification, or the values assigned to existing 
namespaces managed by lANA. 

6.4.1 AVP codes 

This specification assigns the AVP values from the AVP Code namespace managed by 3GPP for its Diameter vendor- 
specific applications. See section 6.3 for the assignment of the namespace in this specification. 
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6.4.2 Experimental-Result-Code AVP values 

This specification has assigned Experimental-Result-Code AVP values 4100-4101 and 5100-5105. See section 6.2. 

6.4.3 Command Code values 

This specification assigns the values 306-309 from the range allocated by IAN A to 3GPP in IETF RFC 3589 [7]. 

6.4.4 Application-ID value 

lANA has allocated the value 16777217 for the 3GPP Sh interface application. 



Special Requirements 



7.1 



Version Control 



The version control mechanisms specified in 3GPP TS 29.229 [6] clauses 7.1, 7.2 and 7.3 apply to this specification. 
The following table of features shall apply to the Sh interface. 

Table 7.1.1 : Features of feature list 1 used in Sh 



Feature 
bit 


Feature 


M/O 


Description 





Notif-Eff 





This feature is applicable to the UDR / UDA and SNR / SNA command pairs. 
If both the HSS and the AS support this feature and if multiple subscriptions 
to notifications are associated with a Pubhc User Identity, the HSS may 
combine the notifications for multiple Data References and Service 
Indications into a single notification message. Similarly the User Data 
Request / Answer will allow multiple data references and Service Indications 
and Identity Sets. The User Data Answer will be able to combine 
DataReference items resulting in the User Data Answer contents including a 
single XML document with the separable XML sections populated. 


Feature bit: The order number of the bit within the Supported-Features AVP, e.g. "1". 
Feature: A short name that can be used to refer to the bit and to the feature, e.g. "MOM". 
M/O: Defines if the implementation of the feature is mandatory ("M") or optional ("O"). 
Description: A clear textual description of the feature. 



The following table shall apply to the Sh interface; the column Application identifier lists the used application 
identifiers on Sh and 3GPP. 

Table 7.1.2: Application identifiers used in Sh 



Application identifier 


First applied 


16777217 


3GPP Rel-5 
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